Node / meshtastic / Meshtastic-Android / files / core / common / src / commonMain / kotlin / org / meshtastic / core / common / util / MetricFormatter.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.common.util

T8b949e/**

* Centralized metric formatting for display strings. Eliminates duplicated `formatString` patterns across Node,

* NodeItem, and metric screens.

*

* All methods return locale-independent strings using [NumberFormatter] (dot decimal separator), which is intentional

* for a mesh networking app where consistency matters.

*/

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffTooManyFunctionsTa5d6ff"Tb4b4b4)

Tff7b72object T56d364MetricFormatter Tb4b4b4{

Tff7b72fun Td2a8fftemperatureTb4b4b4(Te6edf3celsiusTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3isFahrenheitTb4b4b4: Tffa657BooleanTb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3value Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isFahrenheitTb4b4b4) Te6edf3celsius Tff7b72* Te6edf3FAHRENHEIT_SCALE Tff7b72+ Te6edf3FAHRENHEIT_OFFSET Tff7b72else Te6edf3celsius

Tff7b72val Te6edf3unit Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isFahrenheitTb4b4b4) Ta5d6ff"Ta5d6ff°FTa5d6ff" Tff7b72else Ta5d6ff"Ta5d6ff°CTa5d6ff"

Tff7b72return Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3valueTb4b4b4, T79c0ff1Tb4b4b4)Tffd700}Tffd700$Te6edf3unitTa5d6ff"

Tb4b4b4}

Tff7b72fun Td2a8ffvoltageTb4b4b4(Te6edf3voltsTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff2Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3voltsTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff VTa5d6ff"

Tff7b72fun Td2a8ffcurrentTb4b4b4(Te6edf3milliAmpsTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72=

Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3milliAmpsTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff mATa5d6ff"

Tff7b72fun Td2a8ffpercentTb4b4b4(Te6edf3valueTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3valueTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff%Ta5d6ff"

Tff7b72fun Td2a8ffpercentTb4b4b4(Te6edf3valueTb4b4b4: Tffa657IntTb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Tffd700$Te6edf3valueTa5d6ff%Ta5d6ff"

Tff7b72fun Td2a8ffhumidityTb4b4b4(Te6edf3valueTb4b4b4: Tffa657FloatTb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Te6edf3percentTb4b4b4(Te6edf3valueTb4b4b4, T79c0ff0Tb4b4b4)

Tff7b72fun Td2a8ffpressureTb4b4b4(Te6edf3hPaTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3hPaTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff hPaTa5d6ff"

T8b949e/**

* Formats a signal-to-noise ratio, or [UNKNOWN_VALUE] when the packet carried no measurement. 0 dB is a legitimate

* reading, so it must never stand in for a missing one.

*/

Tff7b72fun Td2a8ffsnrTb4b4b4(Te6edf3valueTb4b4b4: Tffa657Float?Tb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3value Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Te6edf3UNKNOWN_VALUE Tff7b72else Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3valueTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff dBTa5d6ff"

T8b949e/**

* Formats a received signal strength, or [UNKNOWN_VALUE] when the radio reported none. 0 dBm is a legitimate

* reading on some radios, so it must never stand in for a missing one.

*/

Tff7b72fun Td2a8ffrssiTb4b4b4(Te6edf3valueTb4b4b4: Tffa657Int?Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Tff7b72if Tb4b4b4(Te6edf3value Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Te6edf3UNKNOWN_VALUE Tff7b72else Ta5d6ff"Tffd700$Te6edf3valueTa5d6ff dBmTa5d6ff"

Tff7b72fun Td2a8ffwindSpeedTb4b4b4(Te6edf3metersPerSecondTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3isImperialTb4b4b4: Tffa657BooleanTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3value Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isImperialTb4b4b4) Te6edf3metersPerSecond Tff7b72* Te6edf3MPH_PER_MPS Tff7b72else Te6edf3metersPerSecond

Tff7b72val Te6edf3unit Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isImperialTb4b4b4) Ta5d6ff"Ta5d6ffmphTa5d6ff" Tff7b72else Ta5d6ff"Ta5d6ffm/sTa5d6ff"

Tff7b72return Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3valueTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff Tffd700$Te6edf3unitTa5d6ff"

Tb4b4b4}

Tff7b72fun Td2a8ffrainfallTb4b4b4(Te6edf3millimetersTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3isImperialTb4b4b4: Tffa657BooleanTb4b4b4, Te6edf3decimalPlacesTb4b4b4: Tffa657Int Tff7b72= T79c0ff1Tb4b4b4)Tb4b4b4: Tffa657String Tb4b4b4{

Tff7b72val Te6edf3value Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isImperialTb4b4b4) Te6edf3millimeters Tff7b72/ Te6edf3MM_PER_INCH Tff7b72else Te6edf3millimeters

Tff7b72val Te6edf3unit Tff7b72= Tff7b72if Tb4b4b4(Te6edf3isImperialTb4b4b4) Ta5d6ff"Ta5d6ffinTa5d6ff" Tff7b72else Ta5d6ff"Ta5d6ffmmTa5d6ff"

Tff7b72return Ta5d6ff"Tffd700${Te6edf3NumberFormatterTb4b4b4.Te6edf3formatTb4b4b4(Te6edf3valueTb4b4b4, Te6edf3decimalPlacesTb4b4b4)Tffd700}Ta5d6ff Tffd700$Te6edf3unitTa5d6ff"

Tb4b4b4}

Tb4b4b4}

T8b949e/** Shown in place of a metric the radio did not report. A symbol, so it needs no translation. */

Tff7b72private Tff7b72const Tff7b72val Te6edf3UNKNOWN_VALUE Tff7b72= Ta5d6ff"Ta5d6ff—Ta5d6ff"

Tff7b72private Tff7b72const Tff7b72val Te6edf3FAHRENHEIT_SCALE Tff7b72= T79c0ff1.8f

Tff7b72private Tff7b72const Tff7b72val Te6edf3FAHRENHEIT_OFFSET Tff7b72= T79c0ff3T79c0ff2

Tff7b72private Tff7b72const Tff7b72val Te6edf3MPH_PER_MPS Tff7b72= T79c0ff2.23694f

Tff7b72private Tff7b72const Tff7b72val Te6edf3MM_PER_INCH Tff7b72= T79c0ff2T79c0ff5.4f